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ABSTRACT 

A program that simulates a Digital Equipment Corporation PDP-11 
computer and many of its peripherals on the A.I. Laboratory Time 
Sharing System (ITS) is described from a user's reference point of 
view. This simulator has a built in DDT-like command level which 
provides the user with the normal range of DDT facilities but also 
with several special debugging features built into the simulator. 
The DDT conroand language was implemented by Richard M. Stallman while 
the simulator was written by the author of this memo. 



Work reported herein was conducted at the Artificial Intelligence 
Laboratory, a Massachusetts Institute of Technology research program 
supported in part by the Advanced Research Projects Agency of the 
Department of Defense and monitored by the Office of Naval Research 
under Contract Number NQQQ14-70-A-O362-OO02, 
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11SIM Reference Manual 

I . Introduction 

11SIM is a program that simulates a Digital Equipment 
Corporation PDP-11 computer I Ref 1|. This simulator Is 
designed to run on the Artificial Intelligence Laboratory PDP* 
10 |Ref 31 system under the ITS monitor |Ref M. A DDT-IIke 
|Ref 5| command facility is Included which makes available 
functions equivalent to those provided by the PDP-11 console, 
the normal range of ODT facilities/ and the use of several 
special debugs I "g features bul 1 1 into the simulator. 

11SIH Is available under ITS as a system program of 
name PDP11. 

The PDP-11 processor simulator was written hy the 
author of this memo. The DDT command language was designed 
and implemented by Richard M. Stallman. 
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1 1 . Processor Simulation 

The PDP-11/20 processor is simulated by 11SIM under 
ITS |Ref b | v/1 th an increase In execution time of about a 
factor of 30. The actual simulated versus real speed ratio 
varied from 25, to 37. for the PDP-11/20 processor maintenance 
programs. Things that would tend to Increase this ratio (I.c* 
slow down simulation) Include activation of "direct to memory" 
Input -out put devices that operate In parallel with the 
processor on a real PDP-11 or frequent program reference to 
such things as the program counter as a register other than as 
an addressing index {I.e.* B I C £7, -{3)), non-existant memory 
locations* or the other special register locations. 

11SIM keeps track of simulated time to one tenth of a 
microsecond based on the nominal timing of the PDP-11/20. 
Delays caused by the EAE (Extended Arithmetic Unit KE11-A) are 
not simulated. For information on the timing treatment of 
other peripherals see the Appendix. 

As a convience, some PDP-11M5 |Ref 21 features are 
also simulated but can be disabled by detaching the "U5" 
device |Sec VMM. With these PDP-11A5 features off* the 
only known Imperfection In the PDP-11/20 processor simulation 
Is that Instructions that specify a register as a source and 
then modify the register in the calculation of the destination 
address will fetch the unmodified register as data. Thus MOV 
53,(3)+ does not gtore the Incremented register 3 as on a 
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real PDP-11. This Is because It is convenient for the 
simulator to fetch the source data before calculating the 
destination address. Digital Fquipment Corporation has said 
It will not guarentee the compatabl 1 i ty of this type of 
instruction on future nodels of the PDP-11 |Ref 11. 
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III, Command Level and Interrupt Conmands 

11SIM has a DDT-llke command level IHcf 5| which the 
user is initially typing at. Whenever command level Is 
entered/ after the first time. It prints out the location and 
symbolic representation of the next Instruction to he executed 
If the simulator were proceeded. (This location Is not "open" 
however I Sec V| . ) Thi 5 is usual 1 y preceded by an i ndlcat ion 
of why command level was entered. For example QUIT, BREAK, 
and COUNT indicate command level was entered due to a |fi, a 
breakpoint |Sec IX|, or a proceed count exhaustion |5ec VIII, 

When first started, 11S1M prints out its version 
number (this should be Included in the report of any bug) and 

initializes the PDP-11 configuration (Sec Villi. If the user 

has no disk file named .P0P11 UNIT), zeroed PDP-11 core is 

attached to SK from zero as with an attach command, causing a 

print out. Command level is then entered with zero as the 

location of the next instruction for the simulator to execute. 

The resulting initial print out Is as fol lows; 

HSlM.nnn 
CORE ■ 3.K 

If the user does have a disk file named .PDP11 (IHIT), 
no core Is initially attached by the simulator. Instead, 
"INIT" Is typed out and after cormand level Is first entered, 
the user's file will be executed as with a :XF I LE |S«c X|. 
The user's INIT file should attach the desired amount of core. 

Command level is entered if the user quits (see |G 
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below this section) or the simulator halts due to a HALT 
Instruction/ a buss error during a trap, or some reason 
related to the debugging features of the simulator. Command 
level types out an exclamation point as a prompt character at 
the beginning of each new line of Input to It. Single 
character rub out is al lowed between activation characters. 
Simulated time does not pas* in command modn. 

The following characters have effect at the interrupt 
level regardless of whether the simulator or command level Is 
active. They are Invisible to simulated proRrams and ignored 
by command level (but see lfl). Some help In getting back to 
command level rapidly while most control the destination of 
normal "console 11 or simulated teletype output, 

A. |ji (£egin) Turns on output to line printer (hut see 
rWALLP |Sec X|). If not available, output will be buffered on 
the disk for later printing by ITS* 

B. |£ (Ind) Turns off output to line printer, 

C. |fl (bell) Thla la the "quit" character, 

C.l If typed while at conmand level It causes 
an immediate error and return to the main command loop, 

C.2 If typed while simulating. It sets up a 
transfer to command level to occur at the end of the current 
Instruction or simulated Input-output cycle. It Is possible 
that due to a bug In the simulator the current instruction or 
1-0 cycle will not end soon. (This Is ^Jtry much more likely 
for a complex newly Introduced 1-0 device than for a basic 
PDP-11 Instruction.) In this case more |£ f s may be typed with 
the following effects: 

C2. a |£|fi This has the sane effect as |GI£ 
and will allow the user to immediately see If he has quit or 
not despite much buffered type out. 

C.2,b ]£|£|£ This causes command level to be 
entered Immediately, probably from within an 1-0 cycle, 
Proceding the simulation will return to whatever was happening 
while a ;G [Sec VIII wf 1 1 start simulation at the beginning of 
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an Instruction* 

D. IQ (fluote) Thfs character causes the immediately 
following character to be treated as an ordinary letter at 
interrupt level and also at the naln program level of command 
level. A IQ v/i 1 1 be Invisible to a program being simulated 
but the following character will always be visible. It is 
useful for Inputlng any of the special characters listed In 
this section. It may also be used to put space, comma, colon, 
and semicolon Into filenames. Rubbing out a character nuoted 
by a |Q also automatically rubs out the |fl. 

E. I£ (Silence) This character deletes all typeout 
until the time It Is Invisibly read at the main program level, 

F. \1 Choice) Turns on typeout, Typeout Is also 
swi tched on by some serious errors, 

G> iy (li'sper) Turns off typeout, except for most 
error messages which bypass this switch. 
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IV, Expressions In 11SIM DOT 

Expressions In 11SIM DDT are composed of syllables and 

operators, Syl tables are composed as fol lows: 

<difilt>::* 0| X| 2| 3| k I 5| B| 7| 21 9 
Oetter>:r» A| B| C # . , X I Y I Z| , | J | * 
<octal-number> ::■ <dl r! t>| <di gi t><octal-numher> 
<decimal-number>: := <di r! t> . | <dlgl t >< dec! ma 1 -number > 
<ASCI I -value>: :- ' <any-characer> I "<any- 

character><any-character> 

<symbol>:;* <letter> | <let terXoc tal-number> | 

<symbolXsymboI> 

<syl lable>: :» <octal -number > | <dec ] ma 1 -number > | 
<A5CI l-value>| <symbo1> 

In the above^ <any-choracter> means either any ASCII 
character not mentioned In section III and not rub-out, or a 
Ifl followed by any mentioned In section III or rub-out- Rub- 
out Is used to Implement a character at a time Input backup 
feature. 

The value of a syllable (assuming no undefined 
symbols) Is a 16. bit number and a flag that says If It Is a 
register number. A register value can come only from a 
regl ster type symbol , The onl y Initial register symbols are 
50/ %1, . , . 26/ %7. An expression Is register valued If and 
only if It contains a term which Is a register valued 
syllable. 

Expressions are conposed of syllables and certain 
operators/ with the indicated precedence/ as fol lows: 



< term> : 
<exprl> 
<expr2> 
<expr3> 



<sy1 lable> | <value> 

■ <term>| -<term>| +<term> 

■ <exprl> 1 <exprl>*<exprl> | <exi>rl> ! <exprl> 

■ <expr2>| <expr2>+<expr2> I <expr2>-<expr2> 
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<exprU>: := <cxpr3> I <expr3>fi<cxpr3> I <expr3>"<expr3> | 
<expr3>*<expr3> 

<expres5ion>; :• <exprh> I <exprUXspace><exprU> 

In the above "!" sinnlfies division, "5" means logical 

and, ""'' , (back slash) neans inclusl ve-or, and "f" means 

exclus i ve-or, A <spece> in an expression perforns the 

operation of addition. 

Since the PDP-11 has multi-word instructions, the 

command level ODT can handle multi-word values. These may be 

composed by an op-code or with anele-brakets as shown below: 

<expr-sequence> : : ■ <expression> I < express Ion >,<expr- 
scQuence> 

<value>: t m Expression? I <op-code-w| th-operands>I 
,l < n <expr-5equence> M > 1 ' 

For an expr -sequence at the top level/ each expression 
is assembled as a successive word* In an embedded expr- 
sequence, only the first expression Is used. Surrounding 
register value expressions with angle brakets strips off their 
regl sterness. 

Op-codes may variously have zero, one, or two operands 
and the operands may be of various sorts. The usual PDP-11 
conventions are followed | Ref 1| except for the set and clear 
flag Instructions where SFL or CFL followed by a space, an 
atsign, and the appropriate flag letters Is used (I.e. SFL PC 
for SEC or CFL @Z for CLZ) . In penral, expressions of the 
right refiisterness may be used In operands. Where a register 
is expected and an ordinary value Is supplied, it is treated 



IIS IM Reference Manual 



Page n 



as a register value (I.e. RTS 7 Is equivalent to RTS 57}, 

The following are some special symbols whose values 
are automat i cal 1 y set. 



% 

tq 

SB 

%R0 

SCORE 

address) . 
%0 

out. 

tdPC 

ISec IX|. 
SL 
$S 
5P 

eHe Hi 



Current location |Ref ii| t 
Location actually open ISec V|. 
Set at entry to simulated program counter. 
Address of last or current instruction. 
Has value of last quantity typed In or out. 
Address of last breakpoint taken ISec IX|* 
Starting address for ;G with no argument, 
Number of bytes attached (first non-exlstant 

Last explicit destination address typed In or 

Sometimes set to address of last Jump or trap 

Length of last quantity typed In or out. 
Last explicit source address typed In or out. 
Last subexpression in a multiword expression/ 



SCSX Address used by ;X |5ec VII |. 

5PATR Location after instruction patched |5ec VI I |. 

PATCH Patch space pointer |Sec VI I | . 

^PMOOE Permanent type out mode ISec V|. 

5TM0DE Temporary type out mode |Sec V|. 

Symbols are also defined for various device registers 

[including the processor "device"). They are listed In the 

Appendix. 
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V. Exam I ning and Depos i 1 1 ng 

In examining and modifying locations, 11SIM command 
level fol lows the same general conventions as PDT |Rpf 5| • 
"/" when preceeded by an expression types out the 
corresponding location in the current node (see helow this 
section for node commands). This conmand changes the values 
of the symbols £. and u \ n * If r.iven no Argument, the value of 
5Q is used and only ". . [5 changed. Open square braket is the 
same as "/ M In all respects except that type out Is In non- 
instruction i.iode. 

The Me " command retypes $Q or its argument If 
supplied, in numeric form. Close square hraket is the same as 

"■" except that it types out In current mode. 

The left arrow (or underbar) command reopens 5. In the 
current mode. 

The :REGS command Is available to examine all of the 
eight procesor general registers. 

Carriage return closes the currently open location and 
depos 1 ts its argument. If any, there. Hor I zontal-tab, 1 i ne- 
f eed, and up- arrow (or ci rcumf 1 ex) do the same hut then type 
out the address of and open a new location. For horizontal- 
tab, this is the location addressed by the previously open 
location. For line feed, this is ,*1 If a byte Is open or 
•+%l. If a word Is open, where %l is the length of 5Q In 
bytes. For up-arrow, it Is .-1 if a byte is open and .-2 If a 
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word Is open. 

There are three sets of type out nodes. The one-shot 
set are refered to during printing and are reset from the 
temporary set at the end of every non-type-out-mode command. 
The temporary set are modified to the permanent v/hencver the 
simulator types out a prompting "I", This happens when DDT Is 
entered and after a carriage return, a colon convnand, nnd some 
other commands. Thus the one-shot mode affects only the next 
command. 

Each set of type out nodes Is a group of bits that can 

be cleared (with a minus sign irrmediately before the node 

character) or turned on for either Just the one-shot set (one 

semicolon), or both the one-shot and temporary sets (two 

semicolons), or all three (three semicolons). For example, ;- 

D;;;N will set numeric node for all sets but clear decimal 

mode in the one shot set. The following Is a complete list of 

mode characters: 

B Byte mode/ when opening an even location, examine 
even addressed byte only. CExamlning an odd location always 
fetches byte only.) 

Decimal mode, when printing a quantity 
numerically/ use base 10. (Normal base Is 8.) 

1 Instruction mode, when opening a location, print 
as an instruction. 

N Numeric mode, overrides symbolic and ASCII modes, 

R "Register" mode/ stops register values form being 
printed symbol Icly, 

S Symbol I c mode. 

I Non-printing mode, when opening a location, don't 

pr I nt its contents, overrides all others. 

" ASCII node/ overrides symbolic, 

1 Both ASCII and bvte modes. 
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These different nodes ore relevant at different points 
In type out. Decimal mode only has effect when It has heen 
decided to output a number. When a location Is opened, "I 11 
mode Is check first. If It Is off, then "I" mode Is checked 
to see If instruction print out should be used. If "I" Is off 
then ASCII and H M" node are successively tested. (In 
examining an odd location or a register or when byte mode Is 
on, instruction mode Is supressed.) When a quantity Is 
output, the same thing happens except the , *l 11 and "I 11 nodes 
are not examined. When a quantity Is printed symbol icly, it 
Is normally printed as the nearest symbol less than the 
quantity plus the difference printed numerically. Special 
things happen for register quantities* These are printed as & 
symbol only If the symbol matches exactly, "R" and "N" node 
are off/ and "S" mode Is on. If printed numericly a * Is 
printed in front only If the context (In an Instruction) does 
not make it clear that the number Is a register. 

Numeric and ASCII mode do not affect the output of 
addresses printed by command level because It Is about to open 
them (I.e./ those generated by 1 1 ne- feed/ breakpoints, etc. ). 
Expressions typed before a mode setting command are treated as 
I f typed afterward. 
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VI. Zeroing, Loading and Humplnjt 

Although the simulated core and disk dunning and 
loading commands load and dump zeros, there exist separate 
commands to zero or set to any other value all or part of core 
and to zero the simulated disk. The commands are as follows: 

SZ Zero all core words (nxcept top iiK. of memory). 

expSZ Set all core words (except top UK) to exp 
where exp is a one word expression. 

<expl,exp2>$Z Zero all core words from pxpJ through 
exp2. 

<expl,exp2,exp3>$Z Set all core words form f*xpl 
through exp2 to exp5, 

:ZERDF Zeros simulated disk. 

Dump files in llSIM can contain many different kinds 
of data. In the list below, the term "core" includes zeroes 
and breakpoint Information |Sec I X I hut not normal ly anythl ng 
in the top kK of memory. Pump commands write In a format 
known about by the load commands {farther below, this section) 
but not acceptable to any normal PDP-11 loader. 

All dump conmands but :CDHP may be followed by a file 
specification which consists of symbols separated by space, 
comma, colon, or semicolon (these characters nay he Included 
in a symbol by preceedlng them with )fl) and ending with a 
carriage return. Symbols terminated by a colon or semicolon 
specify the device and system name respectively. Symbols 
terminated by a space, comma, or, carr i a^e return ore treated 
as, succesively, the first and second file names, the device, 
and the system name. Parts of the file specification not 
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given are supplied from the last load or dump command except 

for the system name which is taken from the last file command 

of any sort. The Initial file name Is IJ1 BIN, 

:DMPCUR Dump all core (Includes breakpoint 
information |Sec IX | ) . 

<cxpl,exp2>:DMPC0R Dump core from expl through expZ. 

:DMPSYH Dump symbol tahle. 

iDMPTPV Dump the trap and PC change action codes (Sec 
■ XI. 

:DMPDF Dump the simulated disk contents (may also 
happen when detaching DF, see AppendlxJ. 

:DMP Dump core/ information on amount of core 

attached, symbols/ and TPV, hut not disk. 

:ODHP Open permanent dump file. After an :ODMP all 

ordinary dump cdnvnaftdfi, until & :CDMP, dump into the permanent 
file. 

:CDMP Close permanent dump file (see rOUMP) . 

$Y Same as :DHP. 

All 11SIM load commands/ listed below/ may he followed 

by file specifications of the same format as for dump corrmands 

(see above, this section). If core being loaded Into isn't 

attached/ it will be attached automatically* When core Is 

attached In this way, a "CORE *" print out will occur. If 

disk information Is loaded and the disk Is not attached, 1 t 

will be attached and a message printed. Load commands know 

about absolute loader format as well as those formats used by 

the above dump commands, 

SL Zero all of core, flush all user symbols, 

zero cumulative virtual time, then load all Items In file 
(Same as SZ SI :FL5YMS : LOAD but also restores ^CSX (:S?CSX) 
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and sets PATCH to prohibit patching (1>PATCH) |5ec VI 1 | until 
reset by the load or the user). 

: LOAD Load all items In file (simulated disk nay 

n l so be loaded by attaching it, see Appendix). 

:LUDCOR Load only core from file. Ipnore symbols, 
TPV, and disk information, 

iLODPTR Sane as : LOAD but uses 8-bit mode for loading 
from the paper tape reader. 
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VII. Execution 

This section lists commands that cause or ore directly 

related to actual simulation of PDP-11 instructions- In the 
case of those commands that cause Indefinitly long simulation, 
control can be returned to command level with a l£ ISec II II* 
Control will automatically revert to command level If a HALT 

is executed, a buss error occurs durlnp. a buss error trap, or 

a debugging stop is reached |Sec IX|. 

SG Start indefinite simulation at location £G0. 

SexpG Execute exp Instruction start i nR at *;G0. 
exp$G Start Indefinite simulation at location exp. 
expl$exp2G Execute cxp2 Instructions stating at 
locat ion cxpl. 

$N Proceed simulation for one instruction, then 

return to command level . 

expSN Proceed simulation for exp Instructions, 
return to command level at end if nothing has caused an 
earl ier return to command level . 

SP Proceed simulation Indefinitely, 

SX Insn (terminate by carriage return) Executes the 
instruction insn by storing it at location 5CSX (Initially 
177720). If Insn causes a transfer, simulation will continue 
until control returns. %7 is always restored on return. 

SX Same as SX insn but executes the I nst ruction 

currently at $CSX. 

exp$X insn Same as SX Insn except that exp Is put in 
SI before executing the instruction and %1 Is restored on 
return. 

expSX Same as expSX insn except It uses the 
instruction current I y at <JCSX, 

exp:S%CSX This command allows the user to nove the 
location used by SX commands to locat I on exp, exp* 2, and 
exp*U. If moved into attached memory below the top UK, the 
SCSX location will be prooerly dumped and loaded |Sec VII. 

SI This is a reinitialization command that 

simulates a RESET Instruction, zeros the cumulative virtual 
time and zeros the processor status register. 
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:BUS5 The simulator remembers various information 
about the last up to three buss errors. This Information, 
which Includes the simulated time of the error. Is printed 
alone with the current time by :8liSS. 

:PAT exp This cofnnond can be Riven only when a 
location Is open ISec VI. It gives the location special 
properties and stores exp, which must be a one word Quantity, 
in It, Attempts to read or write the locactlon by a simulated 
program will be treated as stopping breakpoints ISec IX|, 
Fetching the location as an Instruction will cause a transfer 
to exp. Examining the location at command level will type out 
11 : PAT" before exp and force exp to be typed as an address. 
Depositing with DDT will erase the special features. The : PAT 
command also sets the symbol £PATR to the location of the next 
instruction (the location line feed would have opened). The 
properties of :PAT locations ore correctly dumped and loaded 
ISec VI I. 

|^ This command (control backslash) can be given 

only when a location is open and the symbol PATCH has been 
defined to point to an even non-register location. It has the 
effects of : PAT PATCH but also opens location PATCH. 

! J. Thl s command (control close bracket) is normal 1 y 

used to return to an Instruction sequence that was was patched 
with r. It has the same effect as : PAT SPATR except that If 
given an argument it first stores it and then patches after it 
and it also redefines the symbol PATCH Instead of 5PATR to 
point just after the patch it stores. 
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VIII. Configuration Control 

The configuration of the simulated PDP-11 is 
controlled by the SA and SD commands which attach nnd detach 
devices. These commands may be preceded by an optional 
numeric argument and arc followed by a device name. If no 
device name Is Riven, either command will type a list of legal 
device names. For some devices, an optional file name can 
follow the device name. The exact effect and conventions in 
attaching and detaching all devices are listed in the Appendix 
except for the CORE "device", which is explained below. 

Simulated PDP-11 core is allocated In units of 102k. 
words, Giving a numeric argument to An attach or detach 
command on the CORE device will attach or detach that number 
of 102M, word units. The maximum that may be attached Is 78. 
units. After any attach nr detach coranand on the core device 
the total amount of core then attached is printed out. 

As It is sometimes convenient to have a way of setting 
the amount of core to a particular value regardless of the 
current amount attached, there also exists the exp:CORE 
command. It tries to set the number of attached blocks of 
core to the value of the expression exp, (t then prints the 
amount of core attached, as it does If Riven no argument. 
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IX, Debugging Aids 

The two basic behugglng features are the breakpoint 
feature, described immediately below, and the trap message 
feature described further below, this section. They have heen 
designed to allow the user to enter command level at a point 
In the simulated program likely to he that at which It Is 
going astray. 

The breakpoint feature Is Implemented hy associating a 
seven bit qunatlty with each simulated PDP-11 word. Any 
reference to memory by a simulated program or direct to memory 
input-output device can activate a breakpoint If the 
appropriate bits are on in the Quantity associated with the 
word It is referencing. These bits are as follows: 

1 Breaks on processor instruction fetches. 

2 Breaks on processor write references. 

if Breaks on processor read references except 
Instruction fetches, 

10 Upon breaking/ If this bit Is set/ continue 
simulation/ else enter command level. 

20 Breaks on direct to memory device write. 
k0 Breaks on direct to memory device read. 
100 Breaks on processor instruction fetch/ always 
enters command level/ and clears itself. 

When a break occurs, a message is typed showing 

various information normally including the instruction which 

"caused 11 the break. In the case of Instruction fetch 

breakpoints that enter coirmand level/ this Is the Instruction 

fetch of which caused the break. Autoflush breakpoints/ 

indicated by the 100 bit/ always enter command mode and delete 

themselves. Otherwise/ if the 10 bit is off command level Is 



115 I H Reference Manual Page 70 



entered. 

The break message will also contain the code R, W, or 
I as the break was caused by a read, write, or Instruction 
fetch. RW will appear If the referencing Instruction was 
performing a read-pause-write cycle. For direct to memory 
references, the codes MGDIS RW for the display, 05K R and DSK 
W for the disk, and DM R, DM RW, and DM W for the teletype 
multiplexer will appear. 

The commands to Insert and remove breakpoints arc SB, 
SF, JR, $W, and SU, These commands can take two expressions 
as arguments, one just before and one Just after the "$**. If 
no first argument is given, the command will affect all 
locations where breakpoints can be set. If a single word 
value first argument is given, the command will affect only 
the location with that address- If a multi-word value first 
argument Is given, the locations from the first sub- value 
through the second sub-value will be affected. 

With no second argument, just after the "$ M , SB will 
put in a break of type 7 (print message and enter command 
level on any processor reference) while SU will remove a 
breakpoint by making It type (never break). SF, $R, and 5W 
Insert breakpoints of type 1, i», and 2 repsectively to trap 
just Instruction fetches. Just other reads, or just write 
references. This Is, In fact, the only difference between 
these commands as, with a second argument, all use the bottom 
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seven bits of the second argument as the break type to set. 

The trap message feature allows the user to be 
notified and/ if he desires, to enter command level on any 
PDP-11 trap or transfer of control. There Is an array wl th an 
entry for each even word address from thru 37i*» These arr 
the type of locations used for "trap vectors 11 In the PDP-11. 
Each entry In this array contains one of the following trap 
action codes: 

Do nothing {continue simulation). 

1 Set 5JPC from %OPC and continue. 

2 Print message and continue. 

3 Print message and enter command level . 

The ST command is used for setting these codes. It 
can be given the location It Is desl red to Influence traps 
through as a f I rst argument (Just before the "S") • If this 
argument is omitted, traps through all locations will he 
affected. A second argument tjust after the "$") may be 
supplied which Is the trap action code to he set. If this 
argument Is oml t ted, Is assumed. 

Since the PDP-11 does not trap through location 0, 
this slot in the trap action array Is free and Is used to 
allow any of the above trap actions on all transfer of control 
instructions- The inltal trap vector state is nslT, 
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X. Miscellaneous 

A. Symbols 

At any particular time, there Is symbol table In the 

simulator used by the command level DPT IRef ** | . It contal ns 

op-codes, special symbols, and user defined symbols. The user 

defined symbols are usually Initialized by a load command and 

are saved by some dump commands (Sec VI |, The following 

commands are useful In manipulating user symbols: 

;LSYMS Lists all user symbols and some special 
symbols with their values, 

:FLSYMS Flushes all user symbols. 

exp>sym Defines sym with value exp (should be a one 
word Quanti ty). 

>SYM Defines sym with value 2Q. 

exp>sym|K Defines sym with the value exp but does not 
allow it to be used in symbolic typeout {half-kills the 
symbol ). 

|£sym Complements half killed status of sym. 

: LOOKUP Should be followed by a symbol, Valrets a 
string to HACTRN |Ref 5| which causes it to type out the 
symbol table entry for the symbol . 

B. Time 

A cumulative simulated run time is kept by the 

simulator. Simulated run time does not oass in command level, 

(TIME Prints cumul ati ve simulated run time. ThI s Is 
also printed by the :BUSS command |Sec VII |, 

:ZTIME Zeros the cumulative simulated run time. This 
Is also done by SI |Sec V I J | and SL |Sec Vl|. 

C. Other 

;ALTSEM This command switches the effect of ; and S In 
indicating types of commands. It prints out NOPMAL or 
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SWITCHED as the state Is the same or different fron that 
Indicated In this nanaul. 

:DEBUG This comnand complements a switch and prints 
out ON or OFF depending on the switch's new state. This 
switch Is Initially off. When on It enables the print out of 
the simulation program's nropram counter at certain critical 
points. 

S LOOMS This command lists all ":" commands |5ec XI |. 

:WALLP This conmand has the effect of |j* hut takes an 
optional file specification which controls future output to 
the "line printer". This file is nlso used hy future |£'5. 
|£ terminates "console" output started hy a tWALLP. 

:XFILE This command takes a file specification like 
that used for dump and load commands |Sec VI |, It treats the 
file as text commands to be executed hy the simulator conmand 
level. Characters In the file are echoed on the users 
terminal as they are read. |£, |£, iy, and |W are effective 
|Sec Ml| from the file as well as from the terminal. Any 
errors cause input to be taken from the termianl again (this 
includes Ifi typed on the terminal), SG, SN, and SP termlate 
usage of the command file. 
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Section VI 1 


Wi 


Section VI | 


1 1 1 


• 
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XI . I ndex to Commands 

|8 Section III. 

|E Section III. 

|G Section 111, 

|l (tab) Section V. 

| J(l Ine-feed) Section V. 

|K Section X. 

I L Clear screen. 

JM(carrlage-return) Terminates file specifications and 
some commands Section VI, Section V. 

|N Same as 

I P Same as 

|Q Section 

|V Section 

|W Section 

1 1 Reference 3, 

r(control backslash) Section VII. 

I I (control close braket) Section VII. 

S(alt-mode) Starts a class of commands Indicated by 
the following character. See commands In this 11st ASCII 
ordered by character* 

I Section IV. 

;!, ;; !, ;;; I Section V. 

Section IV. 

Section V. 

# Section IV. 
% Section IV. 

Section IV. 
Section IV. 
Section V. 

* Section IV. 

♦ Section IV. 
Section IV. 

/ Section V. 

: Starts a class of commands indicated hy 

the following symbol. See commands In this list ASCII ordered 
by symbol. 

; Starts a class of commands indicated by 

the next fol lowing non-semicolon character. See commands In 
this list ASCII ordered by character. 



ii 



" . . t t 



I 



1 • r I . . l I 

* t t t r f 4 



< 


Section IV. 


■ 


Section V. 


> 


Section IV, Section 


SA 


Section VIII. 


: ALTS EM 


Section X. 


;B, ;;B, 


;;;B Section V. 


SB 


Section IX. 


:BUSS 


Section VI 1 . 


: CDMP 


Section VI . 



X. 
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:CORE Section VIII. 

;D, ;;D, ;;;D Section V. 

5D Section VIII, 

:DEBUG Section X. 

:DHP Section VI . 

:DMPC0R Section VI. 

1 DM PDF Section V|. 

:OMPSYM Section VI . 

:DHPTPV Section VI. 

$F Section IX. 

:FL5YMS Section X. 

SG Section VI I . 

;l, ;; I, ;;;l Section v. 

$L Section VI . 

:LOAD Section VI . 

:LODC0R Section VI . 

:LDDPTR Section VI . 

:LO0KUP Section X. 

iLSYMS Section X. 
;M, ;;N, ;;;M Section V. 

SN Section VII. 

:ODMP Section VI. 

5P Section VI I . 

:PAT Section VI I . 

SR Section IX. 

;R, ;;R, ;;;R Section V. 

:REGS Section V. 

;S, ;;S, ;;;S Section V. 
:S%CSX Section VI 1 . 

ST Section IX. 

:TIME Section X. 

SU Section IX. 

SW Section IX. 

:VJALLP Section X. 

SX Section VI I . 

;XFI LE Section X. 

$Y Section VI. 

:ZERDF Section VI . 

IZTIHE Section X. 

I (open braket) Section V. 
^{back slash) Section IV. 
|(close braket) Section V. 
I ( up arrow) Section V. 
Section V. 
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Appendix of Device Registers 

This appendix lists all device registers (pseudo- 
memory locations with naglc properties) simulated hy 11SIM. 
They appear in order of Increasing address and are grouped hy 

"device". 

Each lettered section represents a device whose 
symbolic name or names, if any, appear in all capital letters 
after the section letter. Such names nre the lee*' device 
names to use with the SA attach and SD detach commands |Sec 
Villi. After the section heading line, a list of interrupt 
vectors and priorities. If any, for that device appear. Then 
there Is an explanation of the details of the device's 
simulation, attachment, and detachment. In all cases except 
the Knight display. It is assumed that the user is familiar 
with the device's normal operation from manufacturer 
literature- For the Knight display (section A> a fuller 
explanation Is given. 

Final ly, each section has a list of register locations 

and bits in each register. Just after the register's octal 

address and just after each subfield or bit will appear one of 

the following codes: 

RO flead flnly. This register or field is unaffected 
by writting into it. The data in It can only be read. 

R/w £ead lirite. These bits can be read or written 
by the user's program, 

WO llrlte finly. This register or field Is always 
read as zero but has some effect on being written Into. 
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US ilot Simulated. These bits are not simulated. 
For a register, this means that the location will he non- 
existent. For a bit or field, the bits are always read as 
zero and wrltting them has no effect. 

♦ 

The symbolic name of each register appears In all 

capital letters after the above code after the octal address 
of the register. This name, with a t prefixed. Is a defined 
symbol In HSiH's DDT whose value is the address of the 
register. A general description of the register is given 
after Its symbolc name and a descrltlon of each used bit or 
field In the register Is given below the main register line. 
All bit numbers are decimal and the notation n:m means bits n 
through m Inclusive of bits n and m. 

Unless otherwise stated, all the register locations 
associated with a device will be non-exlstant when the device 
Is not attached and attaching a device already attached Is 
identical to detaching It and then attaching It. 

The simulation routines for these devices were written 
by the author of this memo except for the FT device which was 
Implemented by Richard M. Stallnan. 
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A. HGDIS, The Knight Display 

270* Interrupt vector 5»prIority 

The Knight display controller allows up to eight 
consoles to be attached to a PDP-11. In the simulator, this 
device is not initially attached. When attached, it uses the 
DEC 3**0 display to simulate three consoles (number 0, 1, and 
2) In three quadrants of Its screen. The fourth/ lower ri ght 
hand quandrant di splays simulator Information Includi ng the 
output from a :REGS and :BUSS command. Each word fetched for a 
particular display console as a display command Is decoded as 
fol lows: 
bl t 11 JJ* 

No-op, rest Ignored. 

1 Increment command. I3:ll=di rection. 10;8-count. 
7:0=bl ts. 

1 PushJ. 13:0=destlnation word address. 

Ml 11 1Z IX 

110 lOreset X. 9-reset Y. 8«stop. 7"pop. 

6"popJ . 

110 1 UMntonstfy. 9:0»delta Y. 
110 10 10*Intenslfy. 9:0=delta X. 
110 11 l0*intensl fy. 0:f)-delta X and Y. 
1 1 1 - - No-op r rest ignored. 

The reset X and reset Y functions set the appropriate 
coordinate regl sters to zero* The point (0,0) is at the 
center of the screen and the upper right quadrant is *X, +Y. 
Each coord 1 nate register is night bits. 

In increment mode, the count field (in which zero 
implies eight) is the number of bits starting from bit 7 down 
that are used as follows: 

dlr bit X Y 
U 0-1 

U 1 -1 -1 
5 0-10 

5 1-1-1 

6 -1 
C 1 -1 +1 

7 +1 
7 1 -1 *1 

The direction can be considered to be one of the eip.ht 
compass points clockwise numbered with zero north. These 
points are then rotated clockwise 22 and a half degrees. Then 
a zero bit means the nearest of N, E, 5, or W and a one hit 
means the nearest of HE, SE, 5W, or HVJ. A point Is displayed 
at the end of each Increment. 

In the delta X and Y commands, bit H and R have no 
effect currently hut are reserved for future expansion of the 
coordinate registers. DIts 7 through are 2 1 s complement 
added to the appropriate coord i nate register(s). A point is 
displayed at the new coordinates If the intensify bit Is on. 
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The lower lb. hits of a pushj type display command arp 
shifted left one to Rive the (unrelocated) byte address that 
Is transfered to. A simple transfer Is accomplished hy 
pushjlne to a pop command. The stack pointer (unrelocated) 
used by the display processor for each console Is found In 
location IB. plus twice the console number. 

1640U0 R/W NGC5R, Control and status register 

0:7 R/W Run hits for each console (H for console 0). 
Setting bit starts console and sets console PC {unrelocated) 
to the console number times two as a byte address. Clearing 
bit aborts output on console. Hit cleared hy controller when 
console hits a stop command. 

8 R/W Interrupt enahle. Allows interrupt on run 
bit going to 2ero for any console. 

9:11 R0 Number of last console to Ret a non-existant 
memory error. 

12 R/W MXM interrupt enable. If set, bit 15 on will 
interrupt and suspend all displaying even though some of hits 
0: 7 rental n on, 

13:1U R/W Relocation extension hits. See NGREL* 

15 R/W Non-existant memory error. Can he set for 
checking purposes. 

101*042 R/W NGREL, Relocation pointer. 

1:15 R/W Relocation for display addresses, extended by 
NGCSR bits 13:1U. All memory locations fetched from or stored 
Into by the Knight display have their address relocated hy the 
addi tlon of the relocation pointer. 
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E, PK, The KW11-P Programmable Clock 

10ii»interrupt vector 6-priorlty 

This device is not initially attached. It does not 
take any file name after It In an attach command hut a non- 
zero prefix numeric argument will he taken as the "line 
frequency" for rate 2 operation. This is Initially 00. The 
cumulative simulated time is used to drive the PK dpvice so 
Its actions correspond to simulated real tine* 

1725i<0 R/W PKCSR, Control and Status Register 

R/W Run, allows clock to run, cleared hy 
underflow In Mode n, 

1:2 R/W Rate select as follows: 
1 1 rate 
D 100,000 Hz 

1 10,000 Hz 

1 Line frequency. 
] 1 External . 

3 R/W Mode, if zero underflow stops clock hy 
clearing bit 0, if one clock continues counting after 
underflow. 

U R/W When zero, clock counts down, if one, clock 

counts up. 

5 R/W Setting this bit causes clock to count hy 

one. 

6 R/W Interrupt enable, allows hit 7 to Interrupt. 

7 R/W Turned on by underflow, 

15 RO Turned on by underflow with bit 7 set, 
cleared by clearing bit 7. 

17251*2 WO PKCSB, Counter Set Buffer 

0:15 WO Sets counter, cleared by underflow In mode 0, 
used to restore counter on underflow In mode 1. 

1725(*U RO PKC, Counter 

0:15 RO Current state of counter. 



115IM Reference Manual — Appendix Page 32 



C. DC, OCR, DCT, Asyncronous Line Interface 

30i4=lnterrupt vector 5"pr lor! ty {receive) 
310»lnterrupt vector S»pr lori ty ( transml t) 

This device Is not Initally attached. It may he Riven 
a file specification argument when attahced. Using the PC 
device attaches the same file for both receive and transmit. 
The OCR and DCT devices allow file specifications for just 
receive or transmit. All registers exist if either OCR or PCT 
is attached. 

If a teletype Is attached for input, characters v/1 I 1 
be available as 11SIM nets teletype Interrupts. Characters 
will not be lost due to not reading them fast enough. Mon- 
te let ype Input and any output Is al lowed every ' ten simulated 
microseconds. Characters output when ready Is not on will he 
lost. 

The DC device uses dynamically allocated Input-output 
channels as dlscused under the DM device helow. 

17*j000 R/W RCSR, Receiver Status Register 

D NS Data terminal ready. 

1 R/W Break, In simulator, sends a zero character 
when set, 

2 RO Carrier detect. In simulator Indicates DCR 

attached. 

3;i* r/w Receiver speed. Mo effect In simulator. 

5 RO Par i ty. In simulator always zero indicating 
even pari ty, 

6 R/W Interrupt enable, al lows interrupt on hit 7. 

7 RO Done, Indicates character available in RBUF. 
S NS Supervisory transml t data, 

9:10 R/W Character length. Mo effect in simulator, 

8 

1 7 
10 6 

1 1 5 

12 NS Receiver overrun, 

13 NS Ring Indicator, 

1<i RO Carrier transition. Cleared by reading RCSR. 
In simulator set when DCR attached or detached, 
15 HO Error, OR of hits 12:1^. 

17U002 RO RBUF, Receiver Duffer 

0:7 RO Input character, Reading clears RCSR hit 7. 

17U00** R/W TSCR, Transmitter Status Register 

R/W Request to send. Ho effect In simulator. 

1 RO Clear to send. In sinulator indicates that 
DCT attached, 

2 NS Maintenance. 
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3: h R/U Transni tter speed select* In simulator no 

efffect- 

B R/11 TransmI ttcr Interrupt enable. 

7 HO Ready , I ndicates ready to accept character 
In TBUF. 

D K/M Stop code, f)-2 hits. 1 = 1 hit. Mo effect In 

simulator. 

15 MS Supervl sory recel ve data. 

17'i006 WO TBUF, Transmitter Buffer 

0: 7 WO TransmI tted character. Loading clears TSCR 
bit 7. 
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U. DM, DMR, DMT, Asyncronous lG-llne Single Speed Multiplexer 
31***interrupt vector 5=pr ior I ty (receive) 
520=tnterrupt vector 5-priority (transmit) 

This device Is not Initially attached, A line number 
from zero to fifteen should be supplied as a prefix argument 
to any attach command and a file specification nay he supplied 
after each attach command. An attach on the PM device tries 
to attach the same file for both receive and transmit on the 
specified line. The DMR and OUT devices may he used to attach 
receive and transmit sperarately, A line number from zero to 
fifteen is also usually jtlven with a detach command. DMR and 
DMT may be used to detach just receive or just transmit* If 
no line number is supplied on an attach or detach, nothing Is 
attached ordetached. instead, a print out of the status of 
the DM lines Is made. 

If a teletype is attached for input, charactprs will 
be stored into memory as 11$ I M rets teletype Interrupts. 
Characters may be lost due to tumble table wrap around. Non- 
teletype input and any output is activated every three 
simulated milliseconds. 

The DC and DM devices use dynamically allocated Input- 
output channels. Each receive or transmit attachment on each 

line uses up one channel unless the device attached Is TTY or 
LPT |Ref ill. Currently there are a total of six channels 
avai lable. 

175000 R/W CSR, Control and Status Register 

R/W Receiver enable. When clear disables all 16 
recel vers. 

1 R/W Full-half duplex select. Ignored In 
simulator. 

2 NS Maintenance, 

U : 5 R/W TBR extension hits. These bits also extend 
all other address produced by the DM. If on in the simulator 
they cause a timeout error. 

6 R/W Receiver interrupt enable. Allows hit 7 to 
interrupt. 

7 R/W Done, Set as each character is received. 

12 R/W Transmit Interrupt enable. Allows hits 13:15 
to interrupt. 

13 R/W System overrun. DM unable to pet unlbus In 
time. May be set for checking purposes. 

1»* R/W Timeout, DM non-exlstant memory. May be set 
for checking purposes. 

15 R/W Transmit done. Set as any bit of BAR noes to 
zero, 

175002 R/W BAR, Buffer Active Register 

0:15 R/W One hit per line. Setting starts 
transmission. Clearing aborts transml sslon. Sit set to zero 
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when character count decremented to zero (see TliR). 

17500b R/W BCR, Break Control Register 

0:15 R/W One hit per line. Setting causes continuous 

break tranmlsslon on line until bit cleared by program or 
reset, 

175006 R/U TBR, Table flase Register 

8:15 K/H This Is the relocation pointer for the tables 
in memory used by the DM device. It Is extended by CSR hits 
U:5. Since the bottom eight bits are always zero, the TBR Is 
a multiple of faOO. The first sixteen locations it points to 
are the current byte address of characters being transmitted 
to each line. The next sixteen locations are the tranmission 
byte counts. The third set of sixteen are not used In the 
simulator but are normally the bit assembly words. The fourth 
set of sixteen words is never used hut the following sixty 
four are the receiver tumble table, A internal pointer in the 
DM circles through these words and is incremented once as each 
character received Is stored Into a word. The word will have 
bit 15 on and will have the line nunber In hits 9:12, In the 
simulator, bit 13 will always be on and bit lb always off. On 
a real DM these bits Indicate parity and break respectively* 
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E. EAE, Extended Arithmetic Unit KE11-A 

This device is initially attached. Delays caused by 
EAE operations are not simulated. Hyte node references can 
write in the simulated status regi ster. 

177300 WD niV / Divide 

0:15 WO When the divisor is moved to this address, 
the 32. bit dividend In the AC & MO Is divided hy this number, 

177302 R/W AC, Accumulator 

0:15 R/W High order word of arithmetic unit. Contains 
low order product on multiply, remainder or hifch order 
dividend on divide* 

17730b R/W MQ, Multiplier Quotient 

0:15 R/W Low order word of arithmetic unit. Contains 
low order product or quotient on divide. When written Into, 
its sign Is extended into the AC. 

177306 W0 MUL, Multiply 

0:15 HO When the multiplicand Is loaded Into this 
address^ the EAE multiplies this number by the number In the 
MQ. 

177310 R/W SCSR, Step Count and Status Register 

0:5 H/W The step count which contains the count for 
long shifts and the step count following normalize. 

8 R/W On shifts, set to last bit shifted out of AC 
6 MQ. 

9 RO Indicates that result Is a single word In the 
MQ. (Or of bits 12 and 13, this word.) 

10 R0 Indicates that result Is zero. (And of bits 
11 and 12, this word.) 

11 R0 MQ Is zero. 

12 ItO AC Is zero. 

13 R0 AC Is all l f s. 

Ik R/W Indicates result negative. 

15 R/W XQR of operation causing overflow and bit l*u 

177312 R/W MM, normalize 

0:15 R/W Writing into this address results in the 32. 
bit number in the AC b MQ being normalized. This usually 
means shifting left until the top two bits are different but 
certain special numbers are checked for and handled 
di f f erent I y. Readi ng thi s address fetches the shift count. 

177311* WO LGS, Logical Shift 

0:5 WO Output to this address results In a logical 
shift of the AC & MQ (filling with zeros) the specified number 
of bits, 
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177310 WO 
0:5 WO 
shift of the AC 
being the value 



AR5, Arithmetic Shift 

Output to thl s address causes 
& MQ (siRn extension) with the 
noved to this address. 



an ar I thmet ic 
shift count 
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F. ET, DECtape 

21'»«lnterrupt vector G=priority 

The si-iudtur command structure for attaching this 
device is not yet settled. 

177H0 RO TCST, Control and Status Register 
0:1 NS Extended Data, 
2;it fiS Data Tracks, 
5:6 MS Maintenance. 

7 RO Tape up to speed. Cleared when unit select 
or reverse hit changed, 

8 RO Non-exl s tant memory. Cleared In the sane 
manner as bl t IS. 

9 US Data missed. 

10 RO Dlock missed. 

11 RO Selection error. 

12 RO II legal operation. 

13 NS Mark track error. 
Ik NS Parity error. 

15 RO End zone. Cleared when a zero Is loaded Into 
bit 15 or TCCM. 

1773U2 R/W TCCM, Command Register 

MO Starts action, clears ready, 
1: 3 R/W Corrmand as Indl cated below: 

Stop al 1 "lotion, 

1 Read block number. 

2 Read data. 

3 Read all. 

U Stop motion In selected transport, 
5 Write timing and mark track. 
R Wrl te data. 
7 wrl te all. 
I|l5 R/W Extend hits of buss address. 

6 R/W I nterrupt enable. 

7 RO Ready. 

8:10 R/W Unit select. 

11 R/W Tape direction. 

12 R/W Delay Inhibit. 

13 NS Maintenance. 
15 R/W Error. 

1773iii* R/W TCWC, Word Count 

0:15 R/W Two's complement word count, 

I773b6 R/W TCBA, Buss Address 

0:15 R/W Buss address for memory transfers. 
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177350 MS -, Data Register 
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G. DF, The RF11/R511 Disk 

20*»°Interrupt vector apriority 

This device Is not Inltally attached. It Is the only 
device that nay be Riven n file argument on attaching but acts 
dl f ferently If not c'ven a file arnunent. All other devices 
that take file spec) ft cat ions simpl y use some Initial file as 
changed by previous type-In if no file specification Is 
supplied. This device is simulated hy storing the disk 
contents In the simulator's core image. Two PDP-11 words are 
stored per PDP-10 word. 

The OF device nay be attached hy a load command |Soc 
VII which loads disk contents Information, A message is 
printed and the Information Is loaded Into the simulated disk. 
If an attach command on the DF device is given a file 
argument, the disk is attached and disk Information only is 
loaded from the specified file Into the simulated disk. An 
attach command with no file specification attaches a zeroed 
disk. The ;ZERDF command Is also available to zero the disk 

|Sec VI I . 

Detaching the DF with a file name simulates a :PMPDF 
(Sec VI | and then expunges the disk contents Information In 
core. If no file Is specified and the user has not done a 
sDMPDF then the disk contents Is lost hy detaching the DF 
devl cc. 

Al though In the simulator a disk transfer happens 
Instantaneously In terms of cumulat i ve simulated time, the 
ready flag will not normally come on (possibly causing an 
Interrupt) until the right amount of simulated time has past. 
The user can activate another transfer hy setting go pven when 
ready Is off. 

1771*60 R/W DCS, nisk Control and Status 

I) WO Setting causes the disk to execute the 
function selected hy hits 1:2, clears hits 8:13, and clears 
bit 15 unless bit 1U is set. 

1:2 R/W Select one of three functions as shown In 
this table: 

_Z X Function 

no operation 

1 wrl te 

1 read 

1 1 wrl te check 

5 US Maintenance. 

i* ; 5 R/W Extended memory hits. Cause disk non- 
existent memory error unless both on when addressing an 1-0 
regl s ter. 

6 R/W Interrupt enable. Allows hits 7 and 15 to 
interrupt. 

7 RO Ready. 

8 WO Setting causes "power clear" of disk. 
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9 US Missed transfer. 

10 MS Wrl te lock out. 

11 R0 Non-existent disk. On If DAE bits ?:h are 
non-zero, 

12 MS Data parity error. 

13 R0 Write check error. On if word read from 
memory and word read from disk differ during a write check 
operation. 

Ik HO Freeze. Or of DAE hits 10:15. 

IS RO Error. Or of DCS bits 9:1*1, 

177*62 R/W CMA, Current Memory Address 

ltl5 R/W Current memory address, initially loaded with 

the starting address minus two, incremented after r»ach word Is 
transfered unless DAE bit S Is on. 

177UGb R/W WC, Word Count 

0:15 R/W Word count, loaded with 2' s complement of 

block length and incremented by 1 before each transfer. 
Overflow ends a function. Limits block size to 65,536 words, 

1771*66 R/W DAR, Disk Address Register 

0:10 R/W Selects word of disk track for next transfer. 
Incremented after each transfer. Overflow carries Into track 
address* 

11:15 R/W Selects track for next word to be transfered. 
Carries Into and Is extended by DAE bits 0:1* 

1771*70 R/W DAE, Disk Address Extension and Error 

0:1 R/W Track address extension, carries into bit 2, 
2: b R/W Disk address. In the simulator causes non- 
exlstant disk error if non-zero, carries Into bit 5. 

Disk address overf low, causes non-ex I stant 

Data request late. 

CMA Increment Inhibit. 

Mon-exi stant memory on disk reference. 

C timing track error. 

B timing track error. 

A timing track error. 

Address pari ty error. 

-, Data Buffer Register 
-, Maintenance Register 

ADS, Address of Di sk-Segment 
Real time disk position. 
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H. LP, Line Printer 

200-lnterrupt vector Apriority 

The device Is not initially attached, I t al lows 
output to the "1 i ne printer" through the same path as that 
enabled by IB. (Sec lilt. It nay be given a file specification 
to output to which will effect future Ij£ or ;WALLP output |Sec 
X|* Detaching the LP does not terminated I.B or :WALLP output. 
Characters may be output every 6 simulated microseconds. 
Characters output when done Is not on wl 1 1 he lost, 

17752ft R/W LPS, Line Printer Status 

6 R/W Interrupt enable, allows bit 7 or IS to 
interrupt, 

7 R/W Done, Indicates ready to accept character In 
LPB. 

15 RO Error on output. 

177526 WO LPB, Line Printer Buffer 

0:6 VJO Character to be printed. Loading clears LPS 
bl t 7, 



I. LK, The KW11-L Line-Frequency Clock 
100*Interrupt vector 6" priori ty 

This device Is initially attached. It takes no file 
name after an attach cormand on It but a non-zero prefix 
numeric argument will set the 'Mine frequency" used It Its 
operation. This Is Inltally RO, The cumulative simulated 
time is used to drive the LK so Its actions correspond to 
simulate real time. 

1775M6 RO LKS, Line Clock Status 

6 R/W Interrupt enable, aloows bit 7 to request 
Interupt , 

7 RO Set to one every cycle of line current, 
cleared by reading. 
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J, PR, High f.peed Paper Tape Reader 

70" interrupt vector U»pr I or I ty 
This device is not initially attached. It takes a 
file specification to read from, A nonzero numeric argument 
will set the PR to rad in image or ASCII node as the argument 
is one or greater than nne. Image node Is the initial setting 
and must he used to read properly from the PTR |Ref *i I which 
Is the initial file specification. A character may be read 
fron the PR device every G simulated nicroseconds hut no data 
Is lost If characters arc not read fast enough. 

177550 R/W PR5, Paper Tape Reader Status 

WO Reader enable, requests read of next 
character, can be set only if hit 15 clear, setting clears PRB 
and sets bit 11. 

Interrupt enable, al lows hi ts 7 and 15 to 

Done, set by character available, cleared by 

Busy, set by setting bit 0, cleared hy bit 7 

Error, set hy end of input. 

PRB, Paper Tape Reader Buffer 
Reader character buffer. 



K* PP, High Speed Paper Tape Punch 

7*i b interrupt vector fc«pr lor I ty 
This device Is not Initially attached. It takes a file 
speclfcation to write on, A non-zero prefix numeric argument 
will set the PP to read In Image or ASCII node as the argument 
is one or greater than one* Image mode Is the initial setting 
and must be used to write properly on the PTP device IRef <M 
which is the initial file specification. Characters nay be 
output to the PP device every 30. simulated microseconds. 
Data output when ready is not on is lost* 

17755ii R/W PPS, Paper Tape Punch Status 

6 R/W Interrupt enable* allows bits 7 and 15 to 
interupt. 

7 R0 Ready/ cleared by loading PPB, set when ready 
for more data. 

15 RO Error on output, 

177556 WO PPB, Paper Tape Punch Buffer 
0:7 WO Punch character buffer. 
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L. TK, Teletype Keyboard 

GD»|nterrupt vector Apriority 
This device Is initially attached and allows Input 
from the user's teletype to the simulated PPP-11 program. No 
file specification Is taken by this device hut a non-zero 
prefix numeric argument will set the ratio between simulated 
real teletype speed and real teletype speed. (Thl s Is 
Initially set to 1000.) Thus an argument of one would alllow 
one input character per one tenth second of simulated time or 
ti seconds of real time. In the simulator, as opposed to the 
real PDP-11/ data Is not lost due to not reading It in time. 
However, characters buffered by the time-sharing system will 
be lost on trans 1 1 Ion to command level . 

R/W TKS, Teletype Keyboad Status 
Reader enable, 
1 nterrupt enable, 
none, character available. Clears hit 11 

Busy, character being read, 

TKB, Teletype Keyboard Duffer 

Character buffer, reading clears hit 7 In 



M. TP, Teletype Printer 

BU-lnterrupt vector ii-prlorlty 
This device is initially attached and allows output to 
the "console 11 through the same path as command level type out 
|Sec lll|* No file specification is taken by this device but 
a non-zero prefix numeric argument will set the ratio between 
simulated real teletype speed and real teletype speed. This 
is initially 500. (See description of TK device.) Wrltting 
in TPB when ready Is off will casuse output to be lost. 

17756U R/W TPS, Teletype Printer Status 

2 MS Maintenance control . 

6 R/W Interrupt enable. 

7 RO Ready, 

177566 WO TPB, Teletype Printer Buffer 

0:7 WO Character buffer, clears bit 7 In TPS when 
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II, Console Data Switches Register 
See references. 1 and 2. 

177570 RO SWR, Switch Register 

0:15 RO This location represents the console rfata 
swi tches. A I though read-only for n simulated program/ It can 
be deposited into by command level. 



0. Processor General Registers 
**>■ Interrupt vector 
10"lnterrupt vector 
20" interrupt vector 
30»Interrupt vector 
3U=interrupt vector 
See references 1 and 2. The processor registers are 
printed by :REGS. 

177700 R/W through 177716, 50 through t7 

0:15 R/W %0 through %5 are the PDP-ll's general 
purpose registers. %6 Is used as the stack pointer for 
interrupts. %7 is the program counter. 



115IH Reference Manual — Appendix Page UG 



P. U5 y PPP-11M5 Features 

240*Interrupt vector prior I ty var 1 able 

With this device attached, as It Is Initially, the 
following PDP-11/45 op-codes become available: XOR, MUL, 01 V, 
ASH, ASHC, SXT, GPL, RTT, SOB, and MARK. (Estimated times are 
used for these operations In advancing the cumulative 
simulated time.) The PDP-11/45 segmentation option and 
floating point processor option and the I r assocl a ted 
Instruct! ons are not simulated. See reference 2* 

177772 R/W PIR, Programmed Interrupt liequest 

1:3 R0 Priority level of highest request (bits 
9:15). 

5:7 R0 Same as 1:3. 
9:15 R/W Program set requests for Interrupts. Bit n 
is priority n minus a. 

17777b US -, HAS Stack Limit 



Q. Processor Status Reg I ster 
14=lnterrupt vector 
The trace trap enable bit causes a trap through 14 at 
the end of most Instructions. See references 1 and 2. 

177776 R/W PS, Processor Status 

R/W Carry flag (C). 

1 R/W Overflow flag (V). 

2 R/W Zero flag (Z). 

3 R/W Negative flag (N). 

4 R/W Trace trap enable (T). 

5: 7 R/W Processor priori ty. Interrupts of equal or 
lower priority are Inhibited. 



